home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / sphbit.z / sphbit
Encoding:
Text File  |  2002-10-03  |  4.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. sssspppphhhhbbbbbbbbpppp((((3333GGGG))))                                                          sssspppphhhhbbbbbbbbpppp((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sssspppphhhhbbbbbbbbpppp,,,, sssspppphhhheeeebbbbpppp - delimit specification of bitmapped spheres
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ggggllll////ffffsssspppphhhheeeerrrreeee....hhhh>>>>
  13.  
  14.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee sssspppphhhhbbbbbbbbpppp(((())))
  15.  
  16.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee sssspppphhhheeeebbbbpppp(((())))
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  19.      _n_o_n_e
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      Spheres specified with sssspppphhhhddddrrrraaaa after sssspppphhhhbbbbbbbbpppp and before sssspppphhhheeeebbbbpppp are drawn
  23.      with bitmapped spheres.  The bitmap contains an image of a phong-shaded
  24.      sphere.  The diffuse color of the sphere may be specified by sssspppphhhhccccllllrrrr.
  25.  
  26.      Between sssspppphhhhbbbbbbbbpppp and sssspppphhhheeeebbbbpppp, only calls to sssspppphhhhccccllllrrrr and sssspppphhhhddddrrrraaaa are permitted
  27.      and including any GL calls or other Sphere Library calls will produce
  28.      undefined results.
  29.  
  30. NNNNOOOOTTTTEEEE
  31.      Bitmapped spheres are currently only implemented on the RealityEngine,
  32.      and with several restrictions.
  33.  
  34.      The framebuffer must be configured for RGBmode with the standard buffer,
  35.      ie.  the zbuffer must not be deallocated with zzzzbbbbssssiiiizzzzeeee.... Multisample buffers
  36.      must not be allocated. The projection matrix for bitmapped spheres must
  37.      be orthographic and use of perspective, such as calls to ppppeeeerrrrssssppppeeee or wwwwiiiinnnnddddoooowwww
  38.      will produce undefined results.
  39.  
  40.      The following operations are not obeyed when drawing bitmap spheres:
  41.      accumulation buffering, blending, feedback, fog, lighting, logicop,
  42.      picking, stencil, texturing, and writemask.
  43.  
  44.      The values for blendfunction and logicop are reset to their default
  45.      values.  If writemasking was being used previous to drawing bitmapped
  46.      spheres, the resulting writemask after sssspppphhhheeeebbbbpppp, will be undefined.
  47.      Therefore, it is best too ensure that blendfuction, logicop, and
  48.      writemask modes are not being used when entering the bitmap sphere mode
  49.      to avoid surprises.
  50.  
  51.      On RealityEngine, bitmapped spheres compete for framebuffer memory with
  52.      stereobuffer and at least a medium pixel depth is required to have room
  53.      for both.
  54.  
  55.  
  56. BBBBUUUUGGGGSSSS
  57.      Bitmapped spheres on RealityEngine are currently only available in
  58.      immediate mode.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. sssspppphhhhbbbbbbbbpppp((((3333GGGG))))                                                          sssspppphhhhbbbbbbbbpppp((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      Bitmapped spheres do not clip correctly but pop when clipped against the
  75.      near and far clipping planes. User-defined clipping planes are ignored by
  76.      the bitmapped spheres.
  77.  
  78.      Currently, on RealityEngine, sssspppphhhhbbbbbbbbpppp is relatively slow to execute and so
  79.      it is best to minimize the number of times the bitmap sphere mode is
  80.      entered in a frame.  Draw as many spheres as possible between one set of
  81.      sssspppphhhhbbbbbbbbpppp and sssspppphhhheeeebbbbpppp calls.
  82.  
  83. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  84.      libsphere, sphdra, sphclr, acbuf, blendf, feedba, fogver, logico, lmdef,
  85.      mssize, pick, RGBmod, stenci, texdef, writem, zbsize
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.